Описание
Создает новый объект Group (только в рабочей области ядра
Microsoft Jet).
Set группа = объект.CreateGroup (имя, код)
Параметры
группа
Объектная переменная, задающая создаваемый
объект Group.
объект
Объектная переменная, задающая объект
User или Workspace, в котором создается новый объект
Group.
имя
Необязательный. Выражение или переменная типа
Variant (подтип String),содержащая уникальное имя нового объекта
Group. Сведения о допустимых именах групп приведены в разделе о свойстве
Name.
код
Необязательный. Выражение или переменная типа
Variant (подтип String), содержащая код учетной записи группы. Код
учетной записи группы должен содержать от 4 до 20 букв или цифр. Сведения о
допустимых значениях кода учетной записи приведены в разделе о свойстве
PID (код учетной записи).
Замечания
Метод CreateGroup используется для создания нового
объекта Group в объекте User или Workspace. Если опустить
какие-либо элементы синтаксиса при вызове метода CreateGroup, то можно
задать или изменить значения соответствующего свойства с помощью инструкции
присваивания перед добавлением нового объекта в семейство. После добавления
нового объекта в семейство допускается изменение значений некоторых (но не всех)
свойств группы. Дополнительные сведения приведены в разделах, посвященных
отдельным свойствам.
Если аргумент имя указывает на объект, который уже
добавлен в семейство, то при вызове метода Append возникает ошибка
выполнения.
Для удаления объекта Group из семейства Groups
следует применить к семейству метод Delete.
Пример
Следующая программа использует метод CreateGroup для
создания нового объекта Group; затем делает пользователя "admin" членом
нового объекта Group и печатает списки свойств и пользователей.
Sub CreateGroupX() Dim wrkDefault As Workspace Dim grpNew As Group Dim grpTemp As Group Dim prpLoop As Property Dim usrLoop As User Set wrkDefault = DBEngine.Workspaces(0) With wrkDefault ' Создает и добавляет новую группу. Set grpNew = .CreateGroup("НоваяГруппа", "AAA123456789") .Groups.Append grpNew ' Делает пользователя "admin" членом группы ' "НоваяГруппа", создавая и добавляя объект ' Group в семейство Groups пользователей. Set grpTemp = .Users("admin").CreateGroup("НоваяГруппа") .Users("admin").Groups.Append grpTemp Debug.Print "Свойства " & grpNew.Name ' Отображает семейство Properties объекта НоваяГруппа. ' Свойство PID недоступно для чтения. For Each prpLoop In grpNew.Properties On Error Resume Next If prpLoop <> "" Then Debug.Print " " & prpLoop.Name & " = " & prpLoop On Error GoTo 0 Next prpLoop Debug.Print "Семейство Users объекта " & grpNew.Name ' Печатает семейство Users объекта "НоваяГруппа". For Each usrLoop In grpNew.Users Debug.Print " " & usrLoop.Name Next usrLoop ' Удаляет новый объект Group, созданный ' только для демонстрации. .Groups.Delete "НоваяГруппа" End With End Sub